home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 February / Macworld (1999-02).dmg / Serious Demos / XTension demo / XTension manual 2.0 / XTension manual 2.0.rsrc / TEXT_144.txt < prev    next >
Text File  |  1998-07-18  |  5KB  |  89 lines

  1.  
  2. The General Preferences Dialog               
  3.  
  4. This is where you may configure some of the more 'global' functions of XTension.  You get here from the Preferences item in the Edit Menu.  Notice that there are three 'folders'....
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27. You probably won't need to change these prefs often, but you should know where they are and what they do.  Should you ever lose your XTension prefs from your System Folder, then you will need to set these up again.
  28.  
  29. These items are :
  30.  
  31. Auto save scripts to TEXT.
  32. If checked, each time you save a script from the XTension script editor, XTension will automatically create a text copy of it and put it in the 'Scripts' folder in the same folder as the database.  This allows you to keep copies, and to be able to review all of your scripts using a text or script editor.
  33.  
  34. Auto sort lists.
  35. If checked, XTension will automatically sort all lists into the preferred order each time you restart the program.  If you have carefully moved (dragged) items in lists to be next to other logical things, then you don't want to check this.  
  36.  
  37. No duplicate addresses
  38. If checked, you will not be allowed to create or change a unit which has the same physical address as another in the database.  If you want to do this and you know what you're doing, then turn this off while you make the changes, then turn it back on.  It's a good thing.
  39.  
  40. Monitor only
  41. If checked, this copy of XTension will perform all functions as normal except that it will not send any commands out the serial port.  If there is a X-10 interface on its serial port, it will listen to events, however it will not try to actually issue commands.
  42.  
  43. This feature is specifically to support multiple Macs on a network which are operating in a 'redundant set'.
  44.  
  45. Note that there is a scripting verb which can be used to set this mode conditionally.
  46.  
  47. With version 1.5 and later, you may select this from the File menu.
  48.  
  49. Backup database every XXX minutes.
  50. You may choose the period between automatic backups of the database.  Although XTension does a good job of keeping up with this, you may want to choose a deliberate period for this.
  51.  
  52. DO write current time  (this may be 'Don't' in the pic)
  53. If checked, XTension will write the current time of day to the database on disk.  Normally this is used to keep track of how long XTension had been down in case of a restart.
  54.  
  55. Since this is bothersome to some powerbooks, this is provided to shut it off.  ( If checked, it keeps the hard disk running...)
  56. Since powerbooks are intrinsically 'battery-backed', you can
  57. detect a powerfail and shut down 'softly'.
  58.  
  59. Save script context on Quit
  60. This new Preferences option allows you to specify whether or not you need to save each of your scripts on each 'quit' of the application.
  61.  
  62. If you use 'local variables' with your scripts, saving them at quit will preverve their current values.  If you don't use local variables, you don't need it, and it will save some time on each 'quit'.
  63.  
  64. If you don't know what this is, then don't worry about it.
  65.  
  66. Return key is Edit or Toggle in Lists
  67. With versions 1.7 and later, you can choose how you want to use the Return key when you have selected a unit.
  68.  
  69. Choosing Edit says that you want to edit the characteristics of the selected unit.  Choosing Toggle means that you want the Return key to turn on or off the selected unit, according to its current state.
  70.  
  71. Sunrise/Sunset
  72. These are the calculated times for the current or next sunrise and sunset at your location.  This location is entered via your Map control panel, and the correct local time must also be set.
  73.  
  74. These times are calculated automatically by XTension each day, and at the appointed time for sunrise, XTension will run a script named 'sunrise' which you (may) have created.  Likewise at sunset, for a script called 'sunset'.
  75.  
  76. You can do anything you would like in the sunrise or sunset scripts, to change settings, turn things off or kick off your 'simulated sunrise' scripts.
  77.  
  78. The 'suntimes' are available to your scripts as variables, and there are two verbs which allow you to 'manually' offet the sunrise and the sunset to +/- 90 minutes of the 'real' calculated times.  See the scripting verbs.
  79.  
  80. Lock Windows
  81. If checked, XTension will not allow changes to the database, nor the position of items in lists or views.  This allows you to have a simple way of preventing little fingers from messing up your arrangement of things.  This does not prevent anyone from changing the state of units etc.
  82.  
  83. Whenever you want to change things, just un-check the box.
  84.  
  85. Password
  86. If you want one more level of security than the above check box, then you may create a password and use it to guard the same changes.  It's just a little more difficult to break.
  87.  
  88. By clicking on the Communications Prefs 'tab', we can see how to configure XTension and the serial port.  
  89.